ggggrrrrooooppppssss translates the output of GNU ttttrrrrooooffffffff to PostScript.
Normally ggggrrrrooooppppssss should be invoked by using the groff command
with a ----TTTTppppssss option. (Actually, this is the default for
groff.) If no files are given, ggggrrrrooooppppssss will read the standard
input. A filename of ---- will also cause ggggrrrrooooppppssss to read the
standard input. PostScript output is written to the
standard output. When ggggrrrrooooppppssss is run by ggggrrrrooooffffffff options can be
passed to ggggrrrrooooppppssss using the ggggrrrrooooffffffff ----PPPP option.
OOOOPPPPTTTTIIIIOOOONNNNSSSS
----bbbb_n Workaround broken spoolers and previewers. Normally
ggggrrrrooooppppssss produces output that conforms the Document
Structuring Conventions version 3.0. Unfortunately
some spoolers and previewers can't handle such output.
The value of _n controls what ggggrrrrooooppppssss does to its output
acceptable to such programs. A value of 0 will cause
grops not to employ any workarounds. Add 1 if no
%%%%%%%%BBBBeeeeggggiiiinnnnDDDDooooccccuuuummmmeeeennnnttttSSSSeeeettttuuuupppp and %%%%%%%%EEEEnnnnddddDDDDooooccccuuuummmmeeeennnnttttSSSSeeeettttuuuupppp comments
should be generated; this is needed for early versions
of TranScript that get confused by anything between the
%%%%%%%%EEEEnnnnddddPPPPrrrroooolllloooogggg comment and the first %%%%%%%%PPPPaaaaggggeeee comment. Add
2 if lines in included files beginning with %%%%!!!! should
be stripped out; this is needed for Sun's pageview
previewer. Add 4 if %%%%%%%%PPPPaaaaggggeeee, %%%%%%%%TTTTrrrraaaaiiiilllleeeerrrr and %%%%%%%%EEEEnnnnddddPPPPrrrroooolllloooogggg
comments should be stripped out of included files; this
is needed for spoolers that don't understand the
%%%%%%%%BBBBeeeeggggiiiinnnnDDDDooooccccuuuummmmeeeennnntttt and %%%%%%%%EEEEnnnnddddDDDDooooccccuuuummmmeeeennnntttt comments. Add 8 if
the first line of the PostScript output should be
%%%%!!!!PPPPSSSS----AAAAddddoooobbbbeeee----2222....0000 rather than %%%%!!!!PPPPSSSS----AAAAddddoooobbbbeeee----3333....0000; this is
needed when using Sun's Newsprint with a printer that
requires page reversal. The default value can be
specified by a
bbbbrrrrooookkkkeeeennnn _n
command in the DESC file. Otherwise the default value
is 0.
----cccc_n Print _n copies of each page.
----gggg Guess the page length. This generates PostScript code
the PostScript font is not to be reencoded. This code can
be used with the \\\\NNNN escape sequence in ttttrrrrooooffffffff to select the
character, even if the character does not have a groff name.
Every character in the font file must exist in the
PostScript font, and the widths given in the font file must
match the widths used in the PostScript font. ggggrrrrooooppppssss will
assume that a character with a groff name of ssssppppaaaacccceeee is blank
(makes no marks on the page); it can make use of such a
character to generate more efficient and compact PostScript
output.
ggggrrrrooooppppssss can automatically include the downloadable fonts
necessary to print the document. Any downloadable fonts
which should, when required, be included by ggggrrrrooooppppssss must be
listed in the file ////uuuussssrrrr////llllooooccccaaaallll////lllliiiibbbb////ggggrrrrooooffffffff////ffffoooonnnntttt////ddddeeeevvvvppppssss////ddddoooowwwwnnnnllllooooaaaadddd;
this should consist of lines of the form
_f_o_n_t _f_i_l_e_n_a_m_e
where _f_o_n_t is the PostScript name of the font, and _f_i_l_e_n_a_m_e
is the name of the file containing the font; lines beginning
with #### and blank lines are ignored; fields may be separated
by tabs or spaces; _f_i_l_e_n_a_m_e will be searched for using the
same mechanism that is used for groff font metric files.
The ddddoooowwwwnnnnllllooooaaaadddd file itself will also be searched for using
this mechanism.
If the file containing a downloadable font or imported
document conforms to the Adobe Document Structuring
Conventions, then ggggrrrrooooppppssss will interpret any comments in the
files sufficiently to ensure that its own output is
conforming. It will also supply any needed font resources
that are listed in the ddddoooowwwwnnnnllllooooaaaadddd file as well as any needed
file resources. It is also able to handle inter-resource
dependencies. For example, suppose that you have a
downloadable font called Garamond, and also a downloadable
font called Garamond-Outline which depends on Garamond
(typically it would be defined to copy Garamond's font
dictionary, and change the PaintType), then it is necessary
for Garamond to be appear before Garamond-Outline in the
PostScript document. ggggrrrrooooppppssss will handle this automatically
provided that the downloadable font file for Garamond-
Outline indicates its dependence on Garamond by means of the
Document Structuring Conventions, for example by beginning
%%%%%%%%IIIInnnncccclllluuuuddddeeeeRRRReeeessssoooouuuurrrrcccceeee, %%%%%%%%BBBBeeeeggggiiiinnnnRRRReeeessssoooouuuurrrrcccceeee and %%%%%%%%EEEEnnnnddddRRRReeeessssoooouuuurrrrcccceeee
comments (or possibly the old %%%%%%%%DDDDooooccccuuuummmmeeeennnnttttNNNNeeeeeeeeddddeeeeddddFFFFoooonnnnttttssss,
%%%%%%%%DDDDooooccccuuuummmmeeeennnnttttSSSSuuuupppppppplllliiiieeeeddddFFFFoooonnnnttttssss, %%%%%%%%IIIInnnncccclllluuuuddddeeeeFFFFoooonnnntttt, %%%%%%%%BBBBeeeeggggiiiinnnnFFFFoooonnnntttt and
%%%%%%%%EEEEnnnnddddFFFFoooonnnntttt comments) should be used.